Bonzomatic Launcher
The Launcher is an executable that will provide various control and received shaders from other instances via a Bonzomatic Server . Tutorial
Interface
Run Launcher.exe, you should see this interface
https://scrapbox.io/files/69e9bf39fc4464f697c3d62e.png
1 - Add Coder Manually
2 - Save change to launcher.json (list of coder and other change done)
3 - Connect to Server
4 - Display Advanced participant option
5 - Diaporama mode and configuration
6 - Mosaic Mode
7 - Random Mode
When you start the Launcher without special change on the config, the interface is empty and without any coder list.
Add Coder
Automatic Detection
The easiest way to add coder is to use the automatic coder detection feature.
First of all, you need to agree between all participant to a common network room. eg. ws://drone.alkama.com:9000/jam/.
Participants will configure bonzomatic as sender to ws://drone.alkama.com:9000/jam/coder_name
https://scrapbox.io/files/69e9bfcdfc4464f697c3d800.png
On your side the launcher.json should have the parameter serverURL set to ws:\/\/drone.alkama.com:9000\/jam\/.
On launcher interface, click on the icon https://scrapbox.io/files/69e9bffafc4464f697c3d873.png to connect to server.
If it's properly connected, you should see the icon turning green https://scrapbox.io/files/69e9c033fc4464f697c3d929.png
When participant will connect , you should see them appears on the list of participants
https://scrapbox.io/files/69e9c045fc4464f697c3d963.png
Click on icon https://scrapbox.io/files/69e9c088fc4464f697c3da25.png next to the participant handle to confirm it and start displaying it.
Add Coder Manually
From UI
Click on the button Add Coder
Enter the coder handle in the prompt and click on to confirm it.
https://scrapbox.io/files/69e9c129fc4464f697c3dbce.png
From launcher.json
If you know in advance the list of participant and their handle, you can pre configure it on the Launcher.json by editing the list coders
code:launch.json
"coders": [
"coder1",
"coder2",
"coder3"
],
The launcher will read this list only at startup.
Monitoring
When the participant is with a green mark, it means the launcher receive properly the shader from the remote participant.
When the participant is with a red mark, it means the launcher doesn't receive properly the shader from the remote participant.
https://scrapbox.io/files/69e9c165fc4464f697c3dd63.png
Basic Display
Mosaic (Default mode)
Mosaic mode will display all participants in a grid.
Click on the button https://scrapbox.io/files/69e9c1a5fc4464f697c3de41.png to activate it.
Focus
You can select one particular participant to display full screen by clicking on its handle.
https://scrapbox.io/files/69e9c1b9fc4464f697c3de88.png
Random
Random will just pick a random participant to focus. Click on the button to display a new random participant.
Diaporama
https://scrapbox.io/files/69e9c1cffc4464f697c3df05.png
1 - Activate Diaporama Mode
2 - Tap to measure bpm
3 - Reduce 1 BPM
4 - Increase 1 BPM
5 - Loop when finish
6 - Randomize
Diaporama Mode will generate a "playlist" of participant to play. The change between all participant will be done automatically and the timing can be tweak using the Tap to measure bpm button https://scrapbox.io/files/69e9c1f2fc4464f697c3df5a.png or via Decrease / Increase button for BPM https://scrapbox.io/files/69e9c205fc4464f697c3df7f.png
By default, the Diaporama mode will stop and come back to Mosaic mode after focusing all participants. If you want to loop indefinitvely you need to activate the loop via the button https://scrapbox.io/files/69e9c21ffc4464f697c3dfcf.png
By default, the Diaporama mode will follow the order of participant in the list. You can randomize the selection by clicking
https://scrapbox.io/files/69e9c233fc4464f697c3dffb.png
Mute Participant
You can decide to hide participant using the icon https://scrapbox.io/files/69e9c26cfc4464f697c3e091.png next to the participant handle you want to mute. When muted, the icon is in red https://scrapbox.io/files/69e9c273fc4464f697c3e09b.png and won't appears in the Mosaic or in Random mode. It can still be clicked and shown for focus.
Advanced Participant Options
When cliking to the https://scrapbox.io/files/69e9c2acfc4464f697c3e119.png you will display the Advanced Participant Options that will appears for each participants
https://scrapbox.io/files/69e9c2befc4464f697c3e136.png
1 - Mute participant
2 - Move participant to top of the list
3 - Move participant to bottom of the list
4 - Recycle participant instance. This will restart a fresh instance of bonzomatic for this participant. Use this in case of crash of if the participant bonzomatic windows is behaving not as expected.
5 - Remove participant from list. This will also close the bonzomatic instance for this participant
Key bind
M: Show mosaic mode
D: Launch a diaporama
O: Toggle displaying options
R: Put a random coder in full screen
A: Add a new coder
0-9: coders 1-10 in full screen ctrl+0-9: coders 11-20 in full screen shift+0-9: coders 21-30 in full screen alt+0-9: coders 31-40 in full screen Left/right: show previous/next coder in full screen
F11: toggle shader overlay on all bonzo windows
Technical Details
Windows Coordinate System
1
1 2
1 2
3 4
1 2 3
4 5